home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / calrpt25.arc / CALLRPT.DOC < prev   
Text File  |  1986-04-11  |  17KB  |  396 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 The Call Reporter 
  21.           
  22.                                         A
  23.  
  24.                               Colossus (tm) Utility
  25.  
  26.  
  27.  
  28.                          Version 2.5, Released on 4/3/86
  29.  
  30.  
  31.  
  32.  
  33.           
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.           
  42.           
  43.                            Copyright (C) 1985, 1986 By
  44.           
  45.                                 Mustang Software
  46.                                    Jim Harrer
  47.                                5124 Sedwick Street
  48.                              Bakersfield, CA  93308
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.           Welcome!
  58.           --------
  59.  
  60.           Hello,  thank  you for the time obtaining The Call Reporter.  
  61.           You must be one of the many Colossus Sysops  who  has  often 
  62.           wondered "just how busy is my board" well, The Call Reporter 
  63.           will  tell  you  just  that!  Everything you every wanted to 
  64.           know is displayed,  maybe even more than you really want  to 
  65.           know!  
  66.  
  67.           Being   a   Sysop   myself,   and   fascinated   with  tele-
  68.           communications,  I felt the best way to improve my board was 
  69.           to  know  what my callers did (or didn't use) on the system.  
  70.           The Callers LOG is fine for  a  quick  run  down,  but  what 
  71.           happened over a longer period of time would be better.  That 
  72.           is basically why The Call Reporter was Written.  
  73.           
  74.           Lets Get the Legal Stuff out of the way!  
  75.           ----------------------------------------
  76.  
  77.           The   Call   Reporter  is  distributed  under  the  Userware 
  78.           Marketing method.  It is provided AS IS!  That means, use it 
  79.           at YOUR OWN RISK!  Please don't try to hold Mustang Software 
  80.           liable for system damage,  loss  of  profit,  or  any  other 
  81.           commercial  damage,  including  but  not limited to special, 
  82.           incidental, consequential or any other types of damages.  
  83.  
  84.           Copyright
  85.           ---------
  86.  
  87.           The Call Reporter is Copyrighted by Mustang Software.  It is 
  88.           provided for your personal use.  You may:
  89.  
  90.                 1).  Make as many copies as you wish.
  91.                 2).  Give it to all your friends. (Hint)
  92.                 3).  Post it on your Bulletin Board. (Hint, Hint)
  93.  
  94.           But please DO NOT:
  95.  
  96.                 1).  Distribute the Program without this 
  97.                      documentation.
  98.                 2).  Charge anyone for the program.
  99.                 3).  Or change the program in any way (Hear that 
  100.                      NORTON Fans!)
  101.  
  102.           $$$$$$$$$$
  103.           ----------
  104.  
  105.           Oh God,  most of you will not even read  this  part!  Ok,  I 
  106.           know,  you know this program wasn't written overnight.  And, 
  107.           I know,  you know,  that if it wasn't for this  shareware  / 
  108.           userware  scheme,  there  would  be A LOT LESS public domain 
  109.           programs available!  
  110.  
  111.           So as you can see Mustang Software believes in  distributing 
  112.           all  of  its products in the public domain.  We feel,  after 
  113.           you've had a change to use our programs a couple  of  times, 
  114.           well, uh, you'll want to show us your support by Registering 
  115.           your copy.  
  116.  
  117.           What will you get,  you ask?  Good Question!  In return, for 
  118.           registering your copy of The Call Reporter,  I'll  send  you 
  119.           either   the   current  version  (if  your  using  an  older 
  120.           production) or a copy of the next release.  See,  this  way, 
  121.           Mustang  Software can continue to improve their products and 
  122.           still buy shoes for our kids!  
  123.  
  124.           Registration is simply.  Send us  your  name,  address,  and 
  125.           Product  (with version number) information along with $20.00 
  126.           Check, Money Order, Cash, (please no rolls of pennies) to: 
  127.  
  128.                                 Mustang Software
  129.                                5124 Sedwick Street
  130.                              Bakersfield, CA  93308
  131.  
  132.           Plus,  after you receive your diskette,  we'll notify you of 
  133.           all future updates, revisions, and NEW PRODUCTS!  Yep, that's 
  134.           right, boy I know, WHAT A DEAL!  
  135.  
  136.  
  137.  
  138.           Lets Get on to Business
  139.           -----------------------
  140.  
  141.           The  Call  Reporter  swiftly  reads  through  your  Colossus 
  142.           CALLERS.LOG.  During this time, this little jewel is looking 
  143.           for Key words or phrases like  "off  at"  and  "1200  baud".  
  144.           Like any good analyzer,  it operates on "Good info in,  Good 
  145.           results out".  That means if your  CALLERS.LOG  is  in  good 
  146.           shape, then you can expect good results.  
  147.           
  148.           However,  it can also operate on "TRASH  in  TRASH  out".  I 
  149.           personally hate this one,  if your CALLERS.LOG contains a lot 
  150.           of recorded line noise like, $#*^%&@%*#%)#$%(#_*)%(#$,  well 
  151.           don't expect much!  I tried to trap for as much garbage as I 
  152.           could and deal with it the best way I know how,  however the 
  153.           options are endless of what your log could contain.  If  the 
  154.           Call  Reporter  gives you fits,  then I suggest looking over 
  155.           your CALLERS.LOG.  Keep in mind,  I use a  600K  CALLERS.LOG 
  156.           with over 1800 calls when testing The Call Reporter before I 
  157.           send it out!  
  158.  
  159.           Also, keep in mind, I have tested this version with COLOSSUS 
  160.           version 1.20Q.  As new Colossus versions are released, I may 
  161.           have  to change the way I count the apples!  So bare with me 
  162.           during those periods!  
  163.   
  164.           What exactly will I learn from The Call Reporter!  
  165.           -------------------------------------------------
  166.           
  167.           Ok,  well lets take a look at  the  Statistical  information 
  168.           that is reported.  
  169.  
  170.           An Example could be:
  171.          -----------------------------------------------------------
  172.          |   The REPORTING PERIOD is from 03-24-86 to 04-02-86     |
  173.          -----------------------------------------------------------
  174. -------------------------------------------------------------------------------
  175. | Total Number Of Callers   =     159  | System Efficiency Usage    =   12.7% |
  176. |       300 Baud Callers =   21    13% |     Hours of System Use    =     26  |
  177. |      1200 Baud Callers =  108    68% |--------------------------------------|
  178. |      2400 Baud Callers =   30    19% | Number of New Users added    :   52  |
  179. |--------------------------------------|--------------------------------------|
  180. | Number of Bulletin Read      :  111  | Number of Local Log-ons      :   25  |
  181. |--------------------------------------|--------------------------------------|
  182. | # Times Editorial was Read   :   43  | # Questionnaire Answered     :    0  |
  183. |--------------------------------------|--------------------------------------|
  184. | Number of Messages Left      :    7  | Times Sysop Was Paged        :    2  |
  185. |--------------------------------------|--------------------------------------|
  186. | Number Of Messages Deleted   :   10  | # of Comments to The Sysop   :   31  |
  187. |--------------------------------------|--------------------------------------|
  188. | Download Ratio Warnings Sent :   26  | Time Limit Exceeded Log-offs :    3  |
  189. |--------------------------------------|--------------------------------------|
  190. | # of Illegal log-on attempts :    1  | Logged Off for No Activity   :    2  |
  191. |    Incorrect Password :     1   100% |--------------------------------------|
  192. |    Name in Alias.BBS  :     0     0% |   The Call Reporter, Version : 2.5   |
  193. -------------------------------------------------------------------------------
  194.  
  195. -------------------------------------------------------------------------------
  196. | Total Number of Downloads :    77    | Total Number of Uploads  :    18     |
  197. |    Ascii      :     1      1%        |    Ascii      :     0      0%        |
  198. |    Xmodem     :    40     52%        |    Xmodem     :     5     28%        |
  199. |    Xmodem/CRC :    35     45%        |    Xmodem/CRC :    13     72%        |
  200. |    Ymodem     :     1      1%        |    Ymodem     :     0      0%        |
  201. |-----------------------------------------------------------------------------|
  202. |                        Peak Calling Periods By Hour                         |
  203. |                       ------------------------------                        |
  204. |    00:A  01:A  02:A  03:A  04:A  05:A  06:A  07:A  08:A  09:A  10:A  11:A   |
  205. |       2     0     2     1     3     6     3     2    12     8     7     4   |
  206. |       1%    0%    1%    1%    2%    4%    2%    1%    8%    5%    4%    3%  |
  207. |   ========================================================================  |
  208. |    12:N  01:P  02:P  03:P  04:P  05:P  06:P  07:P  08:P  09:P  10:P  11:P   |
  209. |       8     4    11    15     8     8     5    11     9    12    10     8   |
  210. |       5%    3%    7%    9%    5%    5%    3%    7%    6%    8%    6%    5%  |
  211. |-----------------------------------------------------------------------------|
  212. |                         Calls Broken Down By Day!                           |
  213. |                        ---------------------------                          |
  214. |      Sun       Mon       Tue       Wed       Thu       Fri       Sat        |
  215. |       16        19        37        42        17        16        12        |
  216. |       10%       12%       23%       26%       11%       10%        8%       |
  217. -------------------------------------------------------------------------------
  218.  
  219.  
  220.           Most,  if  not all,  of this information will be familiar to 
  221.           you.  However,  you may want to know how I get some of these 
  222.           results.  
  223.  
  224.           The Call Reporter pulls the Beginning, Ending, date and time 
  225.           from  the CALLERS.LOG.  I DO NOT depend on the creation line 
  226.           in your CALLERS.LOG, we simply start your clock on the first 
  227.           entry whether it be local use  or  not.  The  System  usage 
  228.           does take into account all time spent on the system locally, 
  229.           we  felt  if you were doing Sysop maintenance then that time 
  230.           should be accounted for.  
  231.  
  232.           This differs with Total  Number  of  Calls,  this  does  not 
  233.           include   local  sign-ons.   However,   local  sign-ons  are 
  234.           reported in another area.  
  235.           
  236.           The System Efficiency Usage is the  percentage  your  system 
  237.           was used for Colossus during the dates reported.  The number 
  238.           comes  from  the  total system usage (in minutes) divided by 
  239.           number of minutes between the begin/end date and time.  
  240.  
  241.  
  242.           Number of times  the  editorial  was  read,  represents  the 
  243.           number  of  times the file EDTORIAL.BBS was read.  What ever 
  244.           you call the option on the main menu,  some use it for other 
  245.           usages.  
  246.  
  247.           Everything  else  I  believe  makes  sense.  If  I  get  any 
  248.           questions,  I'll  append  this  documentation  to  cover  my 
  249.           response.  Most of us never really  look  the  documentation 
  250.           over that well anyway!  
  251.  
  252.  
  253.           Anything Else?  
  254.           --------------
  255.           
  256.           YES!  We also breakdown which bulletins were read the  most, 
  257.           so you can tell when a bulletin doesn't get much action!  
  258.  
  259.           We  breakdown  the messages similar to the bulletins however 
  260.           we also show you the average line per message!  
  261.  
  262.           You also get a complete breakdown of the  files  downloaded, 
  263.           which ones and how often!  
  264.  
  265.           User  Download  and  Upload recaps are printed showing which 
  266.           callers uploaded or downloaded the most  files.  This  gives 
  267.           you a quick idea who is doing what, as they say!  
  268.  
  269.           Lastly,  we'll  show  you  what files were uploaded for your 
  270.           eyes only, just incase one got by you!  
  271.  
  272.           Well,  did we forget anything?  If so tell us about  it!  If 
  273.           we like the idea you'll probably see it added!  
  274.  
  275.           
  276.  
  277.  
  278.           Available Options
  279.           -----------------
  280.  
  281.           The  Call  Reporter  by  default will compile and print to a 
  282.           file  a  complete  report.  All  you  have  to  do  is  type 
  283.           "CALLRPT"  at  your DOS prompt and make sure the CALLERS.LOG 
  284.           is in the same directory.  
  285.  
  286.  
  287.  
  288.           I have received some requests from Sysop (see I do listen to 
  289.           your comments) to set up the Call Reporter so you  can  have 
  290.           it not print some information.  Most of you dump the results 
  291.           to  a  Colossus  Bulletin,  therefore displaying the Special 
  292.           Sysop upload files maybe inappropriate.  
  293.           
  294.           Others like  to  have  two  or  three  Bulletins  containing 
  295.           different information such as The Most Popular Downloads.  
  296.           
  297.           Therefore, I have designed switches so you may suppress some 
  298.           information.  Therefore  you  can  customize  your  results.  
  299.           Also,  by making them Command Line switches,  you can  still 
  300.           have  The  Call  Reporter  run  in  Schedule  X,  completely 
  301.           unattended.  What a neat way  to  update  a  bulletin  every 
  302.           night after midnight!  
  303.  
  304.           The Command Line switches available are:
  305.  
  306.                /P ...........   Redirects the output of the report to the 
  307.                                 line printer.
  308.  
  309.                /O=xxxxxxxx.xxx  Where "xxxxxxxx.xxx" equals the 
  310.                                 FILENAME.EXT  for  the  results  to be 
  311.                                 sent.  The default is "ANALYZER.BBS" .
  312.  
  313.                /G ...........   Suppresses the first two Statistical 
  314.                                 Information screens.  
  315.  
  316.                /B ...........   Suppresses the Bulletin Recap.
  317.           
  318.                /M ...........   Suppresses the Message Recap.
  319.  
  320.                /D ...........   Suppressed the Download Recap.
  321.  
  322.                /A ...........   Suppressed the USER Download Recap.
  323.  
  324.                /C ...........   Suppresses the USER Upload Recap.
  325.  
  326.                /S ...........   Suppresses the Sysop Special File 
  327.                                 Upload information.
  328.  
  329.  
  330.  
  331.                /L=x  ........   Where "x" is an integer.  You select 
  332.                                 top number of names and files to print 
  333.                                 in your report.  For example, lets say 
  334.                                 you had 100 different files downloaded 
  335.                                 in two months,  if x was equal  to  25 
  336.                                 then  only  the  TOP 25 names would be 
  337.                                 printed.  This  effects  the  Download 
  338.                                 File,  User  Download  and User Upload 
  339.                                 recaps.  The default is set to 10.  
  340.  
  341.                /H or /?  ....   Displays a help screen showing the 
  342.                                 available switches.
  343.  
  344.  
  345.           Let me know if you would like to see something added!
  346.  
  347.  
  348.           Where is the Call Reporter Going?
  349.           ---------------------------------
  350.  
  351.           Questions, questions,  questions!  Well on the drawing board 
  352.           are the following ideas: 
  353.  
  354.           Version 3.0 
  355.           ===========
  356.  
  357.           Store  all the answers in an external file and have the Call 
  358.           reporter append to this  file,  therefore  allowing  you  to 
  359.           delete your CALLERS.LOG to save disk room.  Plus,  this will 
  360.           keep the processing time down because the CALLERS.LOG  files 
  361.           will  be  smaller.  Wouldn't  it  be  neat  to see what your 
  362.           totals are after 3, 6, or 12 months!  
  363.  
  364.           Version 4.0
  365.           ===========
  366.  
  367.           Add ANSI graphics when displaying the results.  Pie and  Bar 
  368.           graphs  will  be available to display your usage.  You'll be 
  369.           able to display graphically the information  most  important 
  370.           to you.  
  371.  
  372.                     
  373.           Version 5.0
  374.           ===========
  375.           
  376.           Add  the  ability  to  show  comparisons between dates.  For 
  377.           example,  how did the board do in January  '86  versus  June 
  378.           '86.  And of course any other ideas our users have!  
  379.           
  380.           
  381.           So don't you think this is a product worth supporting?  Your 
  382.           support  will show us whether or not this type of product is 
  383.           important to you!  
  384.  
  385.  
  386.           Register Now, while your thinking about it!
  387.  
  388.  
  389.                                           Happy Analyzing!
  390.  
  391.  
  392.                                           Jim Harrer
  393.  
  394.  
  395.  
  396.